home *** CD-ROM | disk | FTP | other *** search
/ Suzy B Software 2 / Suzy B Software CD-ROM 2 (1994).iso / bootup / boot_a2m / gogost50 / gogost.doc < prev    next >
Text File  |  1995-05-02  |  22KB  |  455 lines

  1.                              GoGo->ST
  2.                            Version  5.0 
  3.                            
  4.                   Program Design and Programming
  5.                                 by
  6.                            Mark Cawthon
  7.                      3550 Pacific Avenue #210
  8.                       Livermore, CA    94550
  9.                       Genie Mail: M.CAWTHON1
  10.  
  11.      GoGo->ST is a replacement for the file selection windows of 
  12. the normal GEM desktop. With a single click of the mouse you can 
  13. run a program or load a document into an application without the 
  14. tedious search through folders and drives.
  15.  
  16.      Version 5.0 is the first to allow access to all ST and TT 
  17. computer resolutions! Intense testing has removed all bugs.
  18.      
  19.      Version 4.2, fixes some minor bugs.
  20.      
  21.      New in version 4.1, many areas have been streamlined to run faster,
  22. also TTP parameters can be selected from the file selector! This greatly
  23. improves the TTP interface. In version 4.0 you had to type each parameter
  24. by hand.
  25.  
  26.      News Flash!: As of 2/20/91, GoGo->ST has been selected to be
  27. included on all new copies of Universal Item Selector from A&D Software!
  28. The owner of A&D Software said he loves GoGo->ST and asked for permission
  29. to do this. If you don't already have Universal Item Selector on your
  30. ST, go out and buy this one. It's the most popular utility ever written
  31. for the ST market in my opinion. 
  32.      
  33.      New in version 4.0, programs of the type TTP are handled just like they
  34. are from the desktop. A dialog box appears whenever you select a '.TTP' type
  35. program for execution and you must enter the path and filename of the file
  36. you wish to be loaded by the TTP program. 
  37.  
  38.      Starting with version 3.0, Memos allows your GoGo->ST main screen
  39. to store and find addresses, phone numbers, appointments, birthdays,
  40. etc. etc. with just a few keystrokes!  Memos can pop-up on the days
  41. you set them to do so. Such as a birthday coming up. Also a Memo will pop-
  42. up 15 minutes before the time set on it, if a time has been set. Use of the 
  43. question mark '?' as a wild card in place of any date or time data allows
  44. for much flexibility in when a Memo will pop-up. Direct any questions about
  45. GoGo->ST to my Genie mailbox M.CAWTHON1 or drop me a note thru the mail!
  46.  
  47.      A New section on Using Memos! is now included with this manual. See
  48. below.
  49.      
  50.      I hope you like your personalized copy of GoGo->ST without
  51. that 1 minute dialog when you first load. Updates are available for 
  52. $10.00. If you are an Un-registered user, see at end of manual how you
  53. too can become one of the select few to receive a personalized copy of
  54. the newest version along with an updated manual! I specialize in FAST
  55. turn-around on all mailings!
  56.  
  57. Installing GoGo->ST
  58.  
  59.   Hard Disk Installation:
  60.      1)   Make a folder for GoGo->ST on any partition on your hard 
  61.           disk.
  62.      2)   Copy the entire contents of the GoGo->ST disk or 
  63.           contents of the de-arced archive file into this folder.
  64.      3)   From the Desktop double click on GOGOST.PRG to execute 
  65.           it the first time.  
  66.      
  67.   Floppy Disk Installation:
  68.      Although GoGo->ST was designed primarily for use on Hard Disk
  69.      systems, it is possible to ease operation of a floppy only 
  70.      system with GoGo->ST.
  71.      1)   Copy the entire contents of the GoGo->ST disk or 
  72.           contents of the de-arced archive file to a floppy.     
  73.      2)   From the Desktop double click on GOGOST.PRG to execute
  74.           it the first time.
  75.      3)   GoGo->ST will load AUTO.LST as the current list.
  76.      4)   On each floppy that you wish GoGo to have access to, 
  77.           copy AUTO.LST from the main GoGo disk to the root 
  78.           directory of the access disk.
  79.      5)   Use the up arrow in GoGo to read the AUTO.LST file 
  80.           on each new floppy. 
  81.      6)   Use the Edit button on GoGo to modify each AUTO.LST
  82.           to load programs from that floppy. 
  83.  
  84.   Setting GoGo->ST to Autoload at bootup time:
  85.      This is essential to getting the most out of GoGo. Two methods 
  86.      are employed to autoboot the GOGOST.PRG, your method will 
  87.      depend on the version of TOS currently on your system.   
  88.      
  89.     TOS 1.2 or Less:   
  90.      1)   Copy the file STARTGEM.PRG to the \AUTO directory of 
  91.           your boot disk. (if you have a hard disk then C:\AUTO)
  92.      2)   Copy the file STARTGEM.INF to the root directory of the 
  93.           boot disk. (hard disk users normally will use C:\)
  94.      3)   Edit STARTGEM.INF to hold the path and filename of your
  95.           copy of GOGOST.PRG (eg. if you have GoGo on drive E: and
  96.           in folder GOGO then path/filename is E:\GOGO\GOGOST.PRG )    
  97.      4)   Reboot to test GoGo autoboot!
  98.  
  99.     TOS 1.4 or Greater:
  100.      1)   From the Desktop, highlight GOGOST.PRG in the folder 
  101.           that you previously set up. 
  102.      2)   While GOGOST.PRG is highlighted, select Options from the 
  103.           menu bar.
  104.      3)   From the Options menu, select Install Application.
  105.      4)   From the Install Application dialog box, select Auto and
  106.           then select Install.
  107.      5)   Select Options from the menu bar, and select Save 
  108.           Desktop.
  109.      6)   Save the Desktop and reboot to test GoGo autoboot! 
  110.  
  111.  
  112.  
  113.  
  114. Getting Started
  115.  
  116.   The Auto List:
  117.      The AUTO.LST file is the Current list when GoGo is first 
  118.      executed. It contains a list of 50 path/filenames which are 
  119.      currently blank.
  120.  
  121.   Add a Program to a List:
  122.      1)   Click with the left mouse button on any one of the 50 
  123.           empty buttons.
  124.      2)   The file selector opens and prompt text replaces the menu 
  125.           bar.
  126.      3)   Select an executable file (.PRG .TOS .TTP) and select OK 
  127.           on the file selector.
  128.      4)   The Box Setup Panel opens.
  129.      5)   Enter the Box Title (if you wish it to be different from
  130.           the filename otherwise leave blank)
  131.      6)   At bottom of Box Setup Panel select GEM or TOS for program
  132.           type.
  133.      7)   Select OK, and Box Setup Panel closes and Box Title name
  134.           shows in button you selected.
  135.      8)   Test by executing your first program from within GoGo by
  136.           clicking the left mouse button on the button you filled.
  137.      9)   When you exit your test program, GoGo should be right 
  138.           there ready for your next execution.
  139.     10)   Lists are automatically saved whenever you add or delete
  140.           something from them.
  141.  
  142.   Add a Document to a List:
  143.      This is the best feature for speeding up your work sessions!
  144.      A document is any file that can be read into a word processor
  145.      or a program editor or a data base manager, etc... Any file 
  146.      that normally you would load after loading an application.
  147.      Gogo allows you to automatically load an application and the
  148.      document you select an one time.
  149.      1)   Click with the left mouse button on any one of the 50 
  150.           empty buttons.
  151.      2)   The file selector opens and prompt text replaces the menu 
  152.           bar.
  153.      3)   Select a document type file (.DOC .DB .TXT .ASC etc...)
  154.           and select OK on the file selector.
  155.      4)   The Box Setup Panel opens.
  156.      5)   Enter the Box Title (if you wish it to be different from
  157.           the document name otherwise leave blank)
  158.      6)   In the box titled Application:, select an empty line 
  159.           (dashed lines)
  160.      7)   The file selector opens. Select an application, such as
  161.           a word processor, that can load the document you 
  162.           selected in step 3. Select OK on file selector.
  163.      8)   Notice the Application you selected fills the line and
  164.           is highlighted to show that this document will first 
  165.           load this application.
  166.      9)   Other applications can fill the 16 application boxes, so
  167.           that changing applications on a document file is very 
  168.           easy in the future.
  169.     10)   For Default Path: on the Box Setup Panel select File in
  170.           most cases. If your program acts strange such as not 
  171.           loading correctly, go back and select Appl (application)
  172.           this will set the path to that of the application, and
  173.           in most cases remedy the problem. But there are about
  174.           1% of programs out there that will not load a document
  175.           correctly using either method and no cure is known, 
  176.           except manually loading the application and loading the
  177.           document from within the application.
  178.     11)   At bottom of Box Setup Panel select GEM or TOS for program
  179.           type.
  180.     12)   Select OK, and Setup Panel closes and Box Title name
  181.           shows in button you selected.
  182.     13)   Test by executing your first document from within GoGo by
  183.           clicking the left mouse button on the button you filled.
  184.     14)   When you exit your test document, GoGo should be right 
  185.           there, ready for your next execution!   
  186.     15)   Hint: If you need to work quickly on one document in
  187.           several different applications, the quickest way to 
  188.           switch is to set up several buttons holding the
  189.           document name but with a different application setup
  190.           to load before it. Then a switch from say word processor
  191.           to program editor for the same document is just a click
  192.           away!
  193.  
  194.   Add a Title to a Button:
  195.      It's possible to only fill in the Box Title in the Box Setup
  196.      Panel. This produces a Title Button that may be used to 
  197.      categorise columns on a list.
  198.  
  199.   Creating a New List:
  200.      GoGo can access over 200 different lists! Each list can have
  201.      it's own application grouping to cover different tasks. 
  202.      1) Select the Setup button on GoGo.
  203.      2) From the Setup Dialog select Save List.
  204.      3) To create the new list just enter a new list name on
  205.         the file selector and select OK. (new lists must go to 
  206.         the same folder as GoGo and end in .LST )
  207.      4) The new list is loaded and becomes the Current list.
  208.      5) Modify the new list to cover a specific set of tasks.
  209.  
  210.   Load a List:
  211.      There are several ways to load a different list.
  212.      1) Click the left mouse button on the Up and Down arrow 
  213.         buttons on GoGo.
  214.      2) Select Setup button, select Load List, select a list from
  215.         the file selector and select OK.
  216.      3) As of version 2.1 it is possible to store a list in a 
  217.         button. Just follow the steps for adding a program but 
  218.         select a list name rather than a program name for the 
  219.         button. To go to that list just click the list button! 
  220.  
  221.   Make a List Auto:
  222.      You may prefer to have a certain list load on bootup of GoGo.
  223.      1) Select the Setup button on GoGo.
  224.      2) From Setup Dialog select Make List Auto.
  225.      3) The Current list will be set to load on your next bootup.
  226.  
  227.   Delete a List:
  228.      Lists no longer needed may be deleted inside of GoGo or 
  229.      outside from the desktop.
  230.      To delete a list while inside of GoGo:
  231.      1) Select Setup button.
  232.      2) Select Delete List from Setup dialog.
  233.      3) Select OK from dialog to delete the list.
  234.  
  235.   Copy a Button:
  236.      You may wish to copy a button to different lists.
  237.      1) Select Copy on GoGo, Copy is highlighted.
  238.      2) Click left mouse button on a button to copy, button is 
  239.         highlighted.    
  240.      3) You can now go to another list using the UP or DOWN arrows
  241.         and complete the copy to a different list! (Ver. 2.3)   
  242.      4) Click left mouse button on a button to copy to. If 
  243.         destination button is already full the copy button will
  244.         overwrite the previous information in the destination
  245.         button.
  246.      5) When done with Copy function, select Copy again to remove
  247.         highlight from Copy button.
  248.  
  249.   Move a Button:
  250.      You may wish to rearrange your buttons for easier access.
  251.      1) Select Move on GoGo, Move is highlighted.
  252.      2) Click left mouse button on a button to move, button is 
  253.         highlighted.    
  254.      3) You can now go to another list using the UP or DOWN arrows
  255.         and complete the move to a different list! (Ver. 2.3)   
  256.      4) Click left mouse button on a button to move to. If 
  257.         destination button is already full the two buttons will
  258.         switch positions. On completion of each Move operation the
  259.         list in which you started the operation will become current.
  260.      5) When done with Move function, select Move again to remove
  261.         highlight from Move button.
  262.  
  263.   Delete a Button:
  264.      Use to selectively modify a new list created from another 
  265.      list.
  266.      1) Select Delete on GoGo, Delete is highlighted.
  267.      2) Click left mouse button on any file buttons you wish to 
  268.         delete.
  269.      3) Click left mouse button on Delete to remove highlight.
  270.  
  271.   Edit a Button:
  272.      When you change the location of a program or document, GoGo 
  273.      needs to know the new path/file names.
  274.      1) Select Edit on GoGo, Edit is highlighted.
  275.      2) Select a button to edit, file selector opens to old 
  276.         path/filename.
  277.      3) Select the new path/filename and select OK.
  278.      4) Select OK on the Box Setup Panel.
  279.      5) When finished, select Edit to remove highlight.
  280.  
  281.   The Log Function:
  282.      If you don't wish to keep track of how long you spend in each
  283.      application.
  284.      1) Select Log On button on Gogo.
  285.      2) Log On changes to No Log to indicate log function off.
  286.      3) Select No Log button to get Log On back.
  287.      4) As of version 2.5, your last setting of Log button is saved during
  288.         exit from GoGo! Now you can set log to No Log and it will stay that
  289.         way until you need to log something. Thanks to several registered
  290.         users for this addition.
  291.  
  292.   To Run a Program not on a list:
  293.      You may wish to test run some program without the extra time 
  294.      of placing it on a list.
  295.      1) Select Run Other button on GoGo.
  296.      2) Select program to run from file selector, and select OK to
  297.         run program.
  298.  
  299. Using Memos!  (New with version 3.1 of GoGo->ST!)
  300.  
  301.   Tech Stuff:
  302.      Memos dynamicaly allocates RAM to hold the memos you create. Memory
  303.      is 180 bytes per memo. If GoGo->ST should find no more memory available
  304.      it will warn you. This is very unlikely. Up to 255 memos can be stored,
  305.      anything over 255 and GoGo->ST will warn you. Any time you delete a 
  306.      Memo, GoGo->ST will give back a like amount of RAM. So if your machine
  307.      is tight on Memory, just try GoGo->ST without any Memos. One way to 
  308.      remove Memos temporarily: Rename GOGO.MSG file to GOGO.MSX, load 
  309.      GOGOST.PRG and your memos will not load. To get your memos back: Rename
  310.      GOGO.MSX to GOGO.MSG and load GOGOST.PRG, your memos will be there.
  311.      
  312.   Add a Memo:
  313.      1) Select Memos from the menu bar. (Or just hit Control and A from the
  314.         keyboard.)
  315.      2) Edit your memo using the up, down, left and right arrow keys. (Or
  316.         use the mouse to point to the next field to edit.)
  317.      3) Click on OK to save the new memo, or click any other button to 
  318.         cancel the memo and not save it.
  319.         
  320.   View, Edit or Delete Memos:
  321.      1) Select Memos from the menu bar. (Or just hit Control and V from the
  322.         keyboard.)
  323.      2) The Memos are sorted by the date at the top left corner, and the 
  324.         first memo to appear will have the earliest date.
  325.      3) Click on Prev or Next to see the rest of your Memos.
  326.      4) Click on Edit to edit any Memo and click OK when done editing. The
  327.         memo may be replaced by another if you change the top left date, but
  328.         it will still be in your list of memos.
  329.      5) To remove a single Memo from your list, select Delete when in the 
  330.         Memo you want to delete. Then select OK when done or select
  331.         Prev or Next to continue thru your Memos.
  332.  
  333.   Find a Memo quickly:
  334.      1) Select Memos from the menu bar. (Or just hit Control and F from the
  335.         keyboard.)
  336.      2) Fill in a few characters of the string, date or time you are looking
  337.         for. Example: Looking for Mark Cawthon's address and phone number,
  338.         you type Caw, or type Mar or the City Mark lives in, etc.
  339.      3) Hit return or click on OK to get to the next Memo that matches your
  340.         string, date or time.
  341.      4) On any Memo click on Edit to edit the Memo, when done click OK 
  342.         two times to get the next Memo that matches.
  343.            
  344.   The Fields that make up a Memo:
  345.      1) Top left corner is the Date of the Memo. For an appointment enter:
  346.         12/31/91 for a Dec.31st,1991 meeting. For a birthday enter:
  347.         12/31/?? for a Dec.31st,Anyyear birthday. This field may be left
  348.         blank.
  349.      2) Top right corner is the Time of the Memo. For an appointment enter:
  350.         08:30p for an 8:30pm meeting time. If you have filled in the 
  351.         required from and to dates (see below) your memo will pop-up 15 mins
  352.         before the appointment once.
  353.      3) Next four lines are for your Memo text. Anything at all can be 
  354.         typed on these lines. Any line may be left blank.
  355.      4) Bottom left corner is the From Date of the Memo. Enter here the
  356.         first date to start displaying this Memo. Example: Your mom's 
  357.         birthday in on Aug.12th, and you want a 10 day advance notice,
  358.         so enter 08/02/?? in the From Date field. The year is anyyear so
  359.         that it will pop-up the menu each year starting on the 2nd of Aug.        
  360.         YOU MUST FILL IN THIS FIELD IF YOU WISH THE MEMO TO POP-UP!
  361.      5) Bottom right corner is the To Date of the Memo. Enter here the 
  362.         last date to end displaying this Memo. Using the example above,
  363.         you would enter 08/14/?? to pop-up the Memo every day from 08/02/??
  364.         till 08/14/??, the extra two days are in case you forget to use your
  365.         computer before her birthday and think she might forgive you for 
  366.         calling her late!        
  367.         YOU MUST FILL IN THIS FIELD IF YOU WISH THE MEMO TO POP-UP!
  368.  
  369.     
  370. Other GoGo->ST Features
  371.  
  372.   Desk Accessories:
  373.      Desk Accessories such as the Atari Control Panel can 
  374.      sometimes wind up behind GoGo, hidden and unselectable!
  375.      Just click the left mouse button on the GOGO->ST logo in the 
  376.      top left corner of GoGo to bring the Accessory back into view.
  377.  
  378.   Clock Function:
  379.      To set the calendar clock, click the left mouse button on the
  380.      time or calendar buttons on GoGo. The time dialog box opens
  381.      and new time and date is entered here. Select SET to set the
  382.      clock and exit back to GoGo. (For those without a battery
  383.      backed up clock, set the clock first thing after bootup.)
  384.  
  385.   Find Function:
  386.      You may have a button on a list somewhere but you can't 
  387.      remember which list.  
  388.      1) Select Find on GoGo.
  389.      2) The Current: list line changes to Find: ___________
  390.      3) Enter a few characters of either the Box name or the 
  391.         underlying filename and a wild card. (ex. Ta*)
  392.      4) Find will search through all of your lists and highlight
  393.         each button that matches your characters and wild card.
  394.      5) When the button highlighted is the one you were searching
  395.         for, just click on it to execute the program!
  396.  
  397.   Check Path Function:
  398.      Here is a quick way to check the path of the filename in any
  399.      button.
  400.      1) Hold down the Alt key on the keyboard.
  401.      2) Click and hold the left mouse button down on a button you
  402.         wish to check.
  403.      3) The menu bar is replaced with the path to the file and
  404.         the button is replaced with the hidden filename.
  405.      4) Let of on the Alt and mouse buttons to restore back to 
  406.         normal.
  407.  
  408.   Logging a Work Session:
  409.      For those who wish to track the time they spend on a project.
  410.      GoGo will automatically keep a log of each access to an 
  411.      application and the length of time in it. Make sure the 
  412.      Log On button on GoGo is showing. (not the No Log)
  413.      When exiting from GoGo the log dialog will ask if you wish
  414.      to save the log to disk, print it or just list it to screen.
  415.      If your logged work is important you MUST save it to disk
  416.      as a filename ending in .LOG or print it. A new log is 
  417.      created each time you reboot GoGo from the desktop. This new
  418.      log is named GOGO.LOG and can be printed as an ASCII file if
  419.      you accidentally exit GoGo without printing it.     
  420.  
  421.   Help Function:
  422.      Help is just a keystroke away. Hit the Help key for a abreviated
  423.      help screen. Works in medium and high resolutions.     
  424.  
  425.  
  426. And now, a message from our sponsor:
  427.  
  428.     Hey by the way, I don't mean to sound like a beggar here but 
  429. have you ever thought of how much time it takes to write and 
  430. debug a full blown program like GoGo->ST? I have spent hundreds 
  431. of late into the night hours on it and I ask you in return to send 
  432. $15.00, this is very low for shareware. If you have never before 
  433. sent money for shareware, start now. My experience with other
  434. shareware offerings has been dismal. But, YOU can make a difference!
  435. Atari computers will survive only if we continue to support our
  436. marketplace!
  437.  
  438.     For the newest version of GoGo->ST, without that persistant 
  439. dialog that you will see until I send you a registered version,
  440. send a $15.00 U.S.A. funds contribution to:
  441.  
  442.                         Mark Cawthon 
  443.                         3550 Pacific Ave. #210 
  444.                         Livermore, CA    94550 
  445.                         U.S.A.
  446.  
  447.                         GENIE Mail Address: M.CAWTHON1 
  448.                         
  449.        PS. Please send a disk. It can be sent in a regular envelope.
  450.            As of Version 4.0, all registrations will be sent in 24 hours.
  451.              
  452.        Please don't distribute your personalized copy of GoGo->ST!
  453.        Thankyou for your support! :^)
  454.        
  455.